table of contents
virt-v2v-output-local(1) | Virtualization Support | virt-v2v-output-local(1) |
НАЗВА¶
virt-v2v-output-local - Using virt-v2v to convert guests to local files or libvirt
КОРОТКИЙ ОПИС¶
virt-v2v [-i* options] [-o libvirt] -os POOL virt-v2v [-i* options] -o local -os DIRECTORY virt-v2v [-i* options] -o qemu -os DIRECTORY [--qemu-boot] virt-v2v [-i* options] -o json -os DIRECTORY [-oo json-disks-pattern=PATTERN] virt-v2v [-i* options] -o null
ОПИС¶
This page documents how to use virt-v2v(1) to convert guests to local files or to a locally running libvirt instance. There are four output modes you can select on the virt-v2v command line:
- -o libvirt -os "POOL"
- -os "POOL"
- This converts the guest to a libvirt directory pool call
"POOL", and instantiates the guest in
libvirt (but does not start it running). See "OUTPUT TO LIBVIRT"
below.
-o libvirt is the default if no -o option is given, so you can omit it.
- -o local -os "DIRECTORY"
- This converts the guest to files in
"DIRECTORY". A libvirt XML file is also
created, but unlike -o libvirt the guest is not instantiated in
libvirt, only files are created.
The files will be called:
NAME-sda, NAME-sdb, etc. Guest disk(s). NAME.xml Libvirt XML.
where "NAME" is the guest name.
- -o qemu -os "DIRECTORY"
- -o qemu -os "DIRECTORY" --qemu-boot
- This converts the guest to files in "DIRECTORY". Unlike -o local above, a shell script is created which contains the raw qemu command you would need to boot the guest. However the shell script is not run, unless you also add the --qemu-boot option.
- -o json -os "DIRECTORY"
- This converts the guest to files in "DIRECTORY". The metadata produced is a JSON file containing the majority of the data virt-v2v gathers during the conversion. See "OUTPUT TO JSON" below.
- -o null
- The guest is converted, but the final result is thrown away and no metadata is created. This is mainly useful for testing.
ВИВЕДЕННЯ ДО LIBVIRT¶
За допомогою параметра -o libvirt ви можете вивантажувати перетворені гостьові системи на основу систему під керуванням libvirt. Існує декілька обмежень:
- Ви можете використовувати лише локальне з'єднання libvirt [див. нижче способи обійти це обмеження].
- Параметр -os pool має вказувати на буфер-каталог, а не щось екзотичніше, наприклад iSCSI [втім, див. нижче].
- Вивантаження можливе лише до гіпервізору KVM.
Workaround for output to a remote libvirt instance and/or a non-directory storage pool¶
- 1.
- Скористайтеся
virt-v2v у режимі -o
local для
перетворення
дисків і
метаданих
гостьової
системи до
локального
тимчасового
каталогу:
virt-v2v [...] -o local -os /var/tmp
Ця команда створює два (або більше) файли у /var/tmp із такими назвами:
/var/tmp/НАЗВА.xml # XML libvirt (метадані) /var/tmp/НАЗВА-sda # перший диск гостьової системи
(замість слова "НАЗВА" має бути назва гостьової системи).
- 2.
- Вивантаження
перетворених
дисків до
буфера
сховища із
назвою
"POOL":
size=$(stat -c%s /var/tmp/НАЗВА-sda) virsh vol-create-as POOL НАЗВА-sda $size --format raw virsh vol-upload --pool POOL НАЗВА-sda /var/tmp/НАЗВА-sda
- 3.
- Внесіть
зміни до
/var/tmp/НАЗВА.xml,
щоб
замінити
/var/tmp/НАЗВА-sda
на назву
буфера.
Іншими
словами,
знайдіть
такий
фрагмент у
XML:
<disk type='file' device='disk'> <driver name='qemu' type='raw' cache='none' /> <source file='/var/tmp/NAME-sda' /> <target dev='hda' bus='ide' /> </disk>
і змініть дві речі: атрибут "type='file'" слід замінити на "type='volume'", а елемент "<source>" слід змінити так, щоб у ньому були атрибути "pool" і "volume":
<disk type='volume' device='disk'> ... <source pool='POOL' volume='NAME-sda' /> ... </disk>
- 4.
- Визначте
остаточну
гостьову
систему у libvirt:
virsh define /var/tmp/NAME.xml
OUTPUT TO JSON¶
The -o json option produces the following files by default:
NAME.json JSON metadata. NAME-sda, NAME-sdb, etc. Guest disk(s).
where "NAME" is the guest name.
It is possible to change the pattern of the disks using the -oo json-disks-pattern=... option: it allows parameters in form of "%{...}" variables, for example:
-oo json-disks-pattern=disk%{DiskNo}.img
Recognized variables are:
- "%{DiskNo}"
- The index of the disk, starting from 1.
- "%{DiskDeviceName}"
- The destination device of the disk, e.g. "sda", "sdb", etc.
- "%{GuestName}"
- The name of the guest.
Using a pattern it is possible use subdirectories for the disks, even with names depending on variables; for example:
-oo json-disks-pattern=%{GuestName}-%{DiskNo}/disk.img
The default pattern is "%{GuestName}-%{DiskDeviceName}".
If the literal "%{...}" text is needed, it is possible to avoid the escape it with a leading "%"; for example, "%%{GuestName}-%{DiskNo}.img" will create file names for the disks like "%%{GuestName}-1.img", "%%{GuestName}-2.img", etc.
ТАКОЖ ПЕРЕГЛЯНЬТЕ¶
АВТОР¶
Richard W.M. Jones
АВТОРСЬКІ ПРАВА¶
Copyright (C) 2009-2020 Red Hat Inc.
LICENSE¶
BUGS¶
To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
When reporting a bug, please supply:
- The version of libguestfs.
- Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
- Describe the bug accurately and give a way to reproduce it.
- Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
2020-04-16 | virt-v2v-1.42.0 |